home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Grab Bag
/
Shareware Grab Bag.iso
/
001
/
zcdoc987.arc
/
zcommdoc.ac
< prev
next >
Wrap
Text File
|
1987-09-27
|
79KB
|
1,801 lines
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 61
EXAMPLE: accept s6 " Your \E[1mFirst\E[0m name please " uses
boldface video to highlight First as it appears in the prompt.
EXAMPLE: accept s2 "File "; rc %s2 prompts the user for a file
name, then receives that file with XMODEM/CRC protocol.
BReak Sends a 200 millisecond break signal.
NOTE: Some modems do not correctly pass the break signal to the
remote.
SEE ALSO: Ctrl-Break key, break string parameter, zmodem B numeric
parameter
BROwse pathspec Browse through the files specified in pathspec. If
pathspec is empty, all files are presented. For each matched
pathname, the filename, date, and length of the file are displayed.
The status line displays some of the commands which may be applied
to each file. Chapter 17.4 describes the browse subcommands, which
provide extensive capabilities for individually selected files.
bye Terminate the connection in progress by sending a long space and
dropping DTR (Data Terminal Ready). After a pause, DTR is
reasserted to allow the modem to originate or answer another
call.[3]
SEE ALSO: o, off commands
call [-N] name[.path][,modifier] Prepare ZCOMM for a new task and
invoke an entry in the Phone Directory.
The 7, A, a, b, C, c, d, E, e, g, H, h, i, j, n, P, p, q, r, S, s,
t, u, v, w, X, x, Z, and z modes are reset. The e, f, g, k, m, p,
q, t, w, and Kermit 8 parameters are reset to their default values.
The search patterns are erased. Permanent string parameters set
with the set _svar command are set to empty.
If path has been specified, it is searched for a line beginning with
name. Otherwise, ZCOMM searches the telephone directory. An
optional modifier (string with a leading comma), if specified, is
not used in the directory search.
If the search is successful, the entire directory entry name is
__________
3. Most dialing scripts include an initial bye command to make sure
any previous call is disconnected.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 62
copied to the remote string parameter. The complete argument
entered on the command line is stored in the args string parameter
visible to the called script. ZCOMM then executes the commands on
the rest of the line (if any), and on succeeding lines beginning
with a space or tab. If the v numeric parameter is greater than
zero, each command from the file is displayed on the screen before
it is executed.
It is not necessary to type the entire name as it appears in the
telephone directory, as ZCOMM will find the first entry that name is
a prefix of. Iff name is empty, execution begins with the first
line of path.
EXAMPLE: call cis1200
call cis1
call cis.C:/newscript
EXAMPLE: call genie,upl Invokes the genie telephone directory entry
with the modifier ,upl available to the called script.
The call command is not limited to making connections. For example,
"call host" in the distribution PHODIR.T file conditions a Hayes
compatible modem to answer incoming calls silently, set parameters,
and activates ZCOMM's host operation.
Most directory entries include a telephone number to dial. If ZCOMM
is used with an autodial modem, the number of retries N (default
none) may be specified.
EXAMPLE: call -40 cbbs-r attempts 40 retries before giving up.
The interval between retries is set by the i numeric parameter.
EXAMPLE: pi4 sets the interval between retries to 4 seconds.
Words To the Wise: Abuse of the retry feature by continually calling
busy numbers may incur the wrath of the Telephone Company.
Especially with Message Unit Accounting, Big Brother may be watching
your telecommunications habits. Some long distance services (MCI,
Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the
phone is allowed to ring (or ring busy) for more than a few seconds.
Consult your telephone company about legal limits to the number and
frequency of retries.
Since some computer services will disconnect within a short time if
no login is attempted, you should start communicating as soon as the
modems are connected. ZCOMM sounds the bell after making the
connection if retries have been specified.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 63
The source, gosub and call commands may be nested with up to six
command/phones file descriptors open at once.[4] A label may be the
target of a call command provided the trailing colon is included in
name.
cat pathspec For Unix users, a synonym to type.
cd [dir] Change to directory dir. If Restricted, dir is checked for
parent directory ("cd ..") and absolute paths ("cd /src") that are
not a prefix of the string parameter Home. Giving cd without an
argument changes to the directory stored in the home string
parameter.[5] ZCOMM then stores the current directory in the pwd
string parameter and displays it unless the v numeric parameter is
less than 0.
EXAMPLE: cd /tmp
SEE ALSO: pwd command, pwd string parameter
chat Enter the term function to chat keyboard to keyboard. Characters
typed by either keyboard are echoed to both ends, and RETURNS echo
as RETURN/LINEFEED. Chat will become hostile if the other end also
echoes characters. (Try it sometime on a timesharing system; it's
fun.) In Host Operation, chat exits if the caller types Ctrl-Z.
chek pathspec Print the "chek" CRC-16 and character count for the
specified files. The CRC-16 used is the 16 bit Cyclical Redundancy
Check used by the public domain CHEK.COM program. The chek command
verifies the identity of two (or more) copies of a file. Iff the
lengths and CRC-16's of two files are the same, the files are almost
certainly identical. Comparing files with the chek command is
faster than transmitting a second copy for character by character
comparisons.
EXAMPLE: "chek", "chek *.c"
HINT: To generate a file containing the CRC's of the files in the
current directory:
>chek.lst
__________
4. Deep nesting may require a decrease in the circular buffer memory
allocation, see Chapter 15.
5. The home parameter is set to the current directory when ZCOMM is
invoked, but may be changed with the set command.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 64
chek *.*
close
After the files are copied, run the commands above (with a different
file name), then compare the two files with DIF.EXE to detect any
that have changed.
SEE ALSO: crc, sum, wc commands
Source for a public domain Unix version of CHEK is available.
close Writes the contents of the circular buffer iff a receive file is
open, then closes the receive and transmit files. ZCOMM complains
if no files were open.
closerx Iff a receive file is open, writes the circular buffer then
closes the receive file.
closetx Closes the transmit file, if it is open.
cls Resets display modes and clears the screen.
CONFerence Enters the term function with a 1 line window for composing
commands and text. Chapter 20.5 gives details.
crc pathspec Print the CRC-32 and character count for the specified
files. The crc command verifies the identity of two (or more)
copies of a file. Iff the lengths and CRC-32's of two files are the
same, the files are almost certainly identical. Comparing files
with the crc command is faster than transmitting a second copy for
character by character comparisons.
EXAMPLE: "crc", "crc *.c"
SEE ALSO: chek, sum, wc commands
Source for a public domain Unix/DOS version of CRC is available.
The crc command is available with flavors of ZCOMM with ZMODEM.
create [-modes] outfile If a receive capture file is open as the
result of a create or t filename command, write the circular buffer
and close it. Then create outfile for use with the term function
with modes. The create command is especially useful when you don't
want to enter the term function immediately.
EXAMPLE: create -ys /tmp/cbbs.tmp"*F
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 65
SEE ALSO: > command
del pathspec Delete the specified files. No message is printed if
files could not be deleted. No confirmation is requested for
massive deletes.
WARNING: As with all ZCOMM pathspec specifications, a directory name
expands to all files in that directory.
SEE ALSO: browse command
demand password Scripts must often verify a caller's identity by
asking for a password. The ZCOMM password command allows a caller
three chances to enter a given password. Failure results in
disconnection.
Password is processed for character escapes. If the result is
empty, no password is demanded. Otherwise the user is prompted to
enter a string matching passowrd in the correct case. Keyboard
input is not echoed.
Three attempts to enter password are allowed. If the password is
not correctly entered, DTR is pulsed to force the modem to
disconnect the caller, and the ? numeric parameter is set negative.
EXAMPLE: demand %password requires the caller to enter a string
matching the contents of the password string parameter.
dir pathspec Display pathnames matching pathspec alphabetized across
the page. Wildcard filename expansions are alphabetical.
EXAMPLE: dir, dir *.c, dir y*.c, dir *.c *.h
dirr pathspec Displays the directory with length and creation date of
each file. dirr displays the number of files matched, number of
blocks, number of kb in those files, and estimated transmission time
at the current transmission speed assuming the fastest protocol
available (ZMODEM or YMODEM-g). XMODEM and Kermit transfers take
longer than the displayed estimates. Wildcard filename expansions
are alphabetical.
dird pathspec Long Form directory, sorted by date.
______________________________________________________________________
5. The y mode overwrites any existing file with the same name. The s
mode strips most control characters from the resulting disk file.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 66
dirt pathspec Long Form directory, reverse sorted by date.
dirl pathspec Long Form directory, sorted by file length.
dirs pathspec Long Form directory, reverse sorted by file length.
dirx pathspec Long Form directory, sorted by file extension.
DISable{-modes} Disable mode(s) affecting the term function. Chapter
19 describes modes affecting the term function.
EXAMPLE: dis -t disables throttle (t mode).
display [[no]dismode] ... Without an argument, prints the display
modes. Display modes preceded by NO are turned off. With one or
more arguments, turn on the specified display mode(s). If an
argument is preceded by no, the specified display mode is turned
off. The display modes are:
nlmode Received newlines (linefeed) display as return/linefeed.
bell=visual Instead of sounding on the speaker, bell characters
cause flashing notes to appear on the screen.
overstrike Overstruck characters are displayed in bold face or
underline (reverse video on CGA) as appropriate.
lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control
codes.
autowrap The 81st character prints on a new line with possible
scrollup.
stat=off Disables ZCOMM's status line.
warpdrive Provides higher display speed without scrolling flicker,
but causes noise (snow/chromablizzard) with CGA display
adapters.
vt100 Emulate DEC VT-100 and VT-102 display codes and most Teletype
5425 codes. VT-52 and Zenith H-19 codes are the default.
mapkb Allow escape codes from the remote or a file to active
alternate keyboard mapping.
3101 Executes IBM 3101 and TI 940 escape codes.
dumb Only null, bs, tab, cr and lf are executed, all others
display. As in real life, dumb takes precedence over vt100,
vt52, and lsi-adm3a emulation.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 67
inhibit Inhibits the display (nothing prints).
SEE ALSO: Q mode
A display command argument changing the terminal emulation (vt100,
lsi-adm3a, 3101, dumb) disables nlmode and overstrike.
display nlmode nobell=visual turns on nlmode display mode and
turns off the visual bell.
display vt100 enables VT100/VT102 emulation used by many computer
systems.
dump pathspec Dump the named files in a side by side hex/ASCII format,
similar to the CP/M users' group DUMP program. The ending character
number is also displayed. Zero length files are not displayed.
echo[c|f] string Echo a line containing a single argument string in
reverse video. Tabs should not be used with the echo command. The
echoc command also echoes its argument to the capture file (if
open), without reverse video. The echof command echoes its argument
to the capture file only.
EXAMPLE: echoc "File not Accepted" outputs a line to the screen
and to the capture file.
EXAMPLE: echo "Dave, This conversation can serve no further
purpose." displays a line on the screen only.
SEE ALSO: lput command, r numeric parameter, character escapes
egrep[m] regular-expression pathspec ** Display lines in the specified
files matching regular-expression. Regular Expressions are
discussed in Chapter .
The egrepm command finds a line matching regular-expression in each
of the specified files, and then pages through the file beginning
with the matched line. At the end of each screen, ZCOMM accepts the
same subcommands used with the findm command.
EXAMPLE: egrep "^Subject:" *.* displays all lines that begin with
"Subject:".
SEE ALSO: findmore command
The egrep implementation does not strip the trailing CR/LF from
lines read from the disk. This affects use of the $ regular
expression magic character. When using the $ magic character, the
CR/LF at the end of normal lines must be represented as "..$".
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 68
This command is not available on small model flavors of ZCOMM.
else Execute the command(s) on the rest of the line if the last if
test performed on the current script level was false.
NOTE: While else statements in programming languages are connected
to a particular if statement according to syntax, the connection in
ZCOMM is to the last if statement executed on the level, regardless
of goto's.
ENAble {-modes} Enable mode(s) affecting the term function. Chapter
19 describes modes affecting the term function.
EXAMPLE: ena -h enables half-duplex (local echo) Half-duplex mode
causes the term function to display keyboarded characters.
EXPand sourcefile pathspec ** For each pathname in pathspec, execute
the commands in sourcefile with the string parameter item set to the
current pathname. The commands in sourcefile must not themselves
contain wildcards (* or ?) or directory pathnames. If no files
match pathspec, sourcefile is not executed.
EXAMPLE: expand plxupl 001* executes the script plxupl once for
each file matching the wild card specification 001*.
Chapter 99 explains the use of this command in more detail.
f [-modes] file Initiates transmission of file with the term function.
One or more term function modes (described in Chapter 19) may be
enabled with the optional modes flag.
If q (TWX) mode is enabled, transmission pauses until the called
system's answerback restarts it with an XON, or until g mode is set.
Otherwise, any XOFF induced transmission pause is reset.
Once the file has been opened with the f command, X mode or
keyboarding F1 or ALT-X will exit the term function with file
incompletely transmitted. The rest of the file may be transmitted
by the t, F2, or wait commands.
EXAMPLE: f -px message uploads message paced by the p mode, which
sends a carriage return and pauses at the end of each transmitted
line until the remote responds with the prompt character (default
line feed). The x mode makes the term function return to the script
after the file has been transmitted.
EXAMPLE: set eolstr \r.; pp1000; pg58; f -p file is useful for
uploading a prepared message to a Compuserve bulletin boards using
the "SIG" editor (not FILGE). The eolstr setting inserts a period
after each line to prevent the Compuserve software from reformatting
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 69
the message. Pp10000 sets the pause timeout to a long time. Pg58
sets the prompt character to ":". f -p file transmits the file.
SEE ALSO: b, g, p, r, n, t, w, x, X modes, eolstr string parameter,
t and wait commands
fail Return from the current script level with failure status.
If called directly by another level of script, that level is
terminated.
If called implicitly by a number presented for dialing, fail
terminates the current dialing attempt. If no retries are left, the
call is abandoned.
find string pathspec Find and display lines containing matches to
string in the specified files. Lower case characters in string
match either case; upper case characters in string match upper case
characters only. If string contains spaces, tabs, or semicolon, it
must be enclosed by double quote characters. ZCOMM C style escapes
may be used to represent control characters and string parameters to
be searched for. Assuming normal DOS files (with CR/LF at the end
of each line), a \n at the beginning of string forces a match to the
beginning of a line. A \r at the end of string (\n if the file(s)
have no returns in them) forces a match at the end of the line.
The file name being searched and its length are displayed in the
status line. For each line that contains a match to string, the
file name (if more than one file), line number, and the text of the
line are displayed.
EXAMPLE: find count *.c finds all occurrences of count or COUNT in
the named files.
SEE ALSO: egrep command
FINDMore string pathspec Findmore finds a line matching string in each
of the specified files, and then pages through the file beginning
with the matched line. Otherwise, it is similar to the find
command. When the screen is filled up, the prompt More? appears.
Typing space displays another screenfull. Typing n skips to the
next instance of string that has not yet been displayed. Typing ^Q
or ^S displays one more character from the file. Typing ^X skips to
the next file.
SEE ALSO: egrepm, page commands
finish Terminates Kermit server operation on the remote system.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 70
get filespec Instructs a remote Kermit server to the transmit the
specified file(s), then receives them. The form of filespec varies
with the remote system; it must be quoted if it contains any special
characters or spaces. The get command only operates with a Kermit
server; use kermit rb to receive files from a regular Kermit
program.
gosub name[.path] Call a script as a subroutine. The phone directory
is searched for name unless another file is specified with .path.
Gosub has the same action as the call command (q.v.), but does not
reset modes, disconnect the modem, or modify the remote parameter.
EXAMPLE: gosub dosig executes the dosig entry in the telephone
directory.
EXAMPLE: gosub .%lib/baud.t executes the commands in c:/yam/baud.t
assuming the lib string parameter contains c:/yam.
SEE ALSO: call command
goto label Search the current script file for label: and execute
commands starting at that line. A label is a line with the label
starting in the first column followed by a colon. Iff label
precedes the current script line, the goback command will locate the
target label more quickly.
grab svar Grab reads a line from the currently open transmit file into
the specified string parameter svar. Unless b mode is on, all
characters starting with the first CR and/or LF are discarded. Grab
inhibits transmission of the open file until g mode is explicitly
set by a command.
On end of file the transmit file is closed and the string parameter
is set empty. End of file can be tested with the t test condition.
SEE ALSO: putv command
HAndshake {on|cts|dsr|dcd|both|off} Some modems and printers cannot
accept continuous full speed data. These devices send control
characters (XOFF and XON) for flow control, or generate a hardware
flow control signal on the CTS, DSR, or DCD pin. The Handshake
command controls the modem port hardware handshake (default off).
If hardware handshaking is selected, an ON to OFF transition on the
specified line stops transmission, and an XON character will not
override the hardware restraint.
After a timeout set by the S numeric parameter (default 60 seconds),
or if characters are in the keyboard input buffer, a warning message
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 71
is displayed, the restraint is released, and characters are sent.
As a special case, handshake on obeys output flow control with the
CTS input signal, asserts input flow control with the RTS output
signal, and disables the transmission of XOFF characters when the
modem input buffer becomes nearly full.
The command handshake both allows either CTS or XOFF to stop output,
in addition to asserting input flow control with the RTS output.
The handshake dcd command enables d mode (q.v.). Subsequently,
selecting a different type of handshaking will disable d mode.
The handshake command releases flow control (allows data to flow if
it had been stopped by handshaking).
Changing the communcations port with the port or portx command
disables hardware handshaking.
SEE ALSO: S numeric parameter
EXAMPLE: handshake cts turns on CTS handshaking.
help The help command uses the helpfile or xhelpfile string parameter
depending on whether ZCOMM is in host operation. Normally, the help
command displays a command summary, pausing every 24 lines.
If the string parameter begins with the character @, ZCOMM used the
rest of the parameter as the inital command to access a pop-up help
program. The contents of the f string parameter are added to this
command, separated by a space. Thus, if helpfile contains "@yhp
/umanh.hlp", giving the help command from the main prompt executes
the DOS command "yhp /umanh.hlp main".
If the called program leaves a file yamhelp.tmp containg script
commands in the current directory, ZCOMM executes this file with a
source command and then deletes it.
SEE ALSO: f, helpfile, xhelpfile string parameters, source command
host The host command conditions ZCOMM to accept incoming calls
unattended. Host operation is described in Chapter 99. The EXIT
key F1 disengages operation state.
NOTE: The host command is normally given only by a script that sets
parameters to their appropriate values. Use the "host" entry in the
distributed PHODIR.T file as a prototype for your application.
SEE ALSO: remote command
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 72
if condition command ... The if command provides powerful condition
testing for scripts. If executes the command(s) on the rest of the
line if condition is true. Otherwise, execution continues
immediately with the next script line. Chapter 25 describes the
testable conditions.
SEE ALSO: else, on commands
ife condition cmd1 ...; cmd2 ... Execute cmd1 ... if condition is
true; otherwise skip to the first semicolon in the rest of the line
and resume execution with cmd2. Iff a semicolon is not present,
execution resumes at the end of the line, useful within the body of
a while command.
EXAMPLE: set f5
@ife %s1 echo "s1 =%s1"; else echo "s1 not set"
Kermit rb [-options] Kermit rb receives files using the Kermit file
transfer protocol. Chapter 18 describes the available options.
File names are given by the sending program. The Kermit programs
must have compatible parity settings as described in Chapter 12,
Kermit Protocol.
Kermit rb receives files from a regular Kermit program; use the get
command to receive files from a Kermit server.
EXAMPLE: kermit pi1; kermit r.R downloads files from an IBM
mainframe.
When the remote Kermit starts sending, If K (Kermit autodownload)
mode is enabled (the default), the ZCOMM term function will sense
the remote Kermit's parity setting and download files without user
intervention.
Kermit sb [-options] pathspec Kermit sb sends the specified files to
either a regular Kermit program or a Kermit server. Chapter 18
describes the available options. The Kermit programs must have
compatible parity settings as described in Chapter 12, Kermit
Protocol.
EXAMPLE: kermit sb file ... sends the specified files to an IBM
mainframe.
keys Keys displays the definitions the user has assigned to the
function keys.
ki Clears the y0...y127 string parameters and causes circular buffer
writing operations to ignore that data from the remote which has
already been displayed.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 73
EXAMPLE: The script fragment
pat 1c "///BEGIN///" "@ki create -+ print.fil"
pat 2c "///END///" "@close"
wait -f30000
will capture the data that arrives between "///BEGIN///" and the end
of the string "///END///". Other data from the remote will not be
captured to disk. The long pattern match fail time (30000 seconds)
makes the the cycle repeat almost indefinitely.
SEE ALSO: W mode
kill Erases all data stored in the circular buffer and restores the
buffer pointers to their initial positions.
l, ll, ls, lx For Unix users, synonyms for the dir commands.
learn lfile TurboLearn(TM) Script Writer records timing information
and term function keystrokes to lfile. The TruboLearn program
tlearn.exe then generates a script using this data. Normally,
learning is initiated after the connection has been established, but
before the first prompt is received from the remote. This is best
accomplished with the F4 key, which activates the tlearn telephone
directory entry.
Function keys, cursor keys, reassigned keys, and scripts[6] should
not be used while learning.
When accepting passwords and other sensitive information, systems
sometimes acknowledge each keyboard character with #, *, x, or X,
instead of the keyboarded character itself. When this happens, do
not type characters faster than the remote responds to them.
The resulting script should be examined for evidence of keyboarding
mistakes, line noise, and dependence on prompts that change each
time you access the system.
__________
6. Other than the dialing script
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 74
The comments below apply when the tlearn script is not used.
EXAMPLE: kill
123-4567; learn lfile
From the ZCOMM main command prompt, enter the desired phone number.
When ZCOMM connects, the learn command enters the term function with
learning (recording) turned on.
<keyboard the operations you wish recorded>
Login to the bulletin board as usual. If you make keyboarding
mistakes, you can edit the script file later.
ALT-C F1
Terminate learning with ALT-C, and return to the main command prompt
with the F1 key.
!tlearn lfile >newscript
From the main command prompt, execute the TurboLearn program tlearn
with a shell escape.
After recording, the tlearn program reads lfile and generates a
series of pattern and put script commands to let ZCOMM search for
the prompts and respond with the proper keystrokes. The resulting
script file newscript may be accessed with the source command.
Alternatively, the last command above may be replaced with
!tlearn -d newdirname lfile >>phones.t
to add the new script to the end of your telephone directory.
The -d dirname causes tlearn to prepend the given new directory
entry name newdirname and the telephone number to the resulting
script commands. The redirection characters >> add the script
commands to the end of your telephone directory.
You can also use the -d newdirname option to tlearn to prepare a new
directory entry in a separate file. Then you can edit this file and
add it somewhere within your telephone directory.
list pathspec The list command uses standard DOS character output
routines and any installed CRT device driver instead of ZCOMM's own
CRT driver. The printer can be enabled with ^P given to DOS (not
ZCOMM). List the specified file(s).
This command closes any open transmit file. List stops/resumes
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 75
printing with ^S. Keyboarding ^C cancels, and ^X skips to the next
file (it might take a few whacks of the keyboard to get ZCOMM to
hear it.) The list command defaults to a type command when ZCOMM is
in host operation.
EXAMPLE: list *.cq
SEE ALSO: browse, type, page commands
lput string Displays string on the console display. String is
processed for character escapes. Lput is useful for scripts sending
cursor control codes to the screen. Control characters and escape
sequences used with the lput command are always decoded with ZCOMM's
default extended VT52/Z19 emulation, which also recognizes ANSI "ESC
[" sequences, regardless of which display emulation is selected.
Unlike the echo command, lput does not display in reverse video and
does not add a carriage return/linefeed to its argument.
SEE ALSO: echo command
lputp string Outputs string to the line printer. String is processed
for character escapes. Strings with embedded nulls (represented
with the \000 character escape) may be used. The lput command
should not be used if the printer is jammed, out of paper, or off
line. These conditions may be tested with the l test condition.
This command is not allowed when ZCOMM is Restricted.
EXAMPLE: if l lputp "\E\017" If the printer is ready, ZCOMM sends
ESC SI to select compressed printing on an IBM 80 CPS printer.
SEE ALSO: l numeric parameter, l test condition
menu Execute script commands from the file name stored in the string
parameter menu.
message The message command allows a caller to keyboard a message
which will be appended to a file specified by the string parameter
messages. The message command allows the caller to type in up to 64
lines of text. A blank line terminates the message. This command
is intended for short messages; long messages should be uploaded
with a file transfer protocol.
more pathspec See page command.
mput string The mput command transmits string to the remote at full
speed. String is processed for character escapes. Unlike the put
and putw commands, mput does not display characters coming from the
remote (they are held in the interrupt buffer). Control and other
special characters may be entered with character escapes. If a
carriage return should be sent, it must be explicitly coded with \r
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 76
at the end of the string.
SEE ALSO: put, putw commands
nulls n When accessing ZCOMM in host operation, nulls sets the number
of nulls (default 0) sent after each linefeed to allow slow
terminals time to scroll.
EXAMPLE: nulls 4
o Terminates a data call by dropping DTR. A bye or speed n command
must be given to reassert DTR before making or answering another
data call.[7]
SEE ALSO: speed, bye, off commands
off Disable the modem by dropping the Data Terminal Ready signal and
return to DOS. A call or speedn command must be given to reassert
DTR before making or answering another data call.
SEE ALSO: x, o commands
open [-modes] file Opens file for transmission with the term function
with modes. The open command should be used when you don't want to
enter the term function immediately, or are already in it. In other
situations, it may be necessary to open the file before dialing to
allow transmission immediately after connection, without the delay
of opening the file from a floppy disk.
SEE ALSO: seek, read, close commands
page pathspec Type the specified file(s) a screenfull at a time. When
the screen is filled up, the More? prompt appears. Typing space
displays another screenfull. Typing ^X skips to the next file.
Typing ^K or ^C terminates the command. This command closes any
open transmit file.
EXAMPLE: page *.doc
SEE ALSO: browse, type, list, findmore commands
PATtern [n[cilpv$] string [action]] (n = 0...24) The pattern command
allows ZCOMM to search for up to 25 different responses from a
__________
7. Most telephone directory entries include a speed command.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 77
remote computer, and take action based on which of those responses
(or none) was "seen". A pattern match can execute specified script
command(s) "on the fly" (c modifier) or return control to the
calling script with an indication of which pattern was matched.
The pattern command causes the next t, f, or wait command (term
function) to search for string in the data received from the
remote/modem. String must be entered exactly as it will be received
from the modem, in the same case and with the same embedded spaces
or tabs. Control characters must be represented with ZCOMM
character escapes. The metacharacter \256 matches any single
character. ZCOMM %string substitutions may be used to define search
patterns. If the % character is to be searched for, it must be
represented as \045.
Parity, NULL, RUBOUT, XON, and XOFF characters received from the
remote do not affect pattern searches. If Kermit AutoDownload (A
mode) is set, strings with SOH (Ctrl-A) cannot be matched. If
ZMODEM AutoDownload (Z mode) is set, strings with CAN (Ctrl-Z)
cannot be matched. If B protocol (c mode) is set, strings with DLE
or ENQ cannot be matched.
Strings of up to 24 characters each may be specified for
simultaneous search by the term function. The search patterns are
"global" among all script levels; a pattern command in a subroutine
affects the patterns set by the calling script(s) and vice versa.
The term function returns when one of the patterns is matched or
when the term function times out with f seconds with no characters
from the remote, as determined by the f numeric parameter, or when
carrier detect is lost. The first wait, t or f command given after
the pattern command begins the search.
When one of the patterns is matched, that pattern is marked as found
and its corresponding action is executed (if present). ZCOMM will
remain in the term function until there is a pause in data
transmission from the remote[8] unless the i or c modifier is used.
The following modifiers may be used. The c, i, and l modifiers are
mutually exclusive.
c The pattern is marked as found and action executed (if
present). The term function then continues searching.
Matching this pattern does not cause a return from the term
function. The condition for this pattern will test true, but
__________
8. Pause length is specified by the q numeric parameter.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 78
the n test condition is not affected.
i (Immediate) The pattern is marked as found and action executed (if
present). The term function then returns immediately.
l (line end delay) The pattern is marked as found and action
executed (if present). The term function then returns after
the first LF character following the matched string.
p (permanent) A pattern with the p modifier is not reset by the
pattern command without arguments. Patterns with the p
modifier may be used to search for disconnect messages within
an entire script. Permanent patterns are reset by the call
command, each item in the outcall queue, and an explicit
pattern command referencing that particular pattern number.
EXAMPLE: pattern 20 "\nCLR" "@off" disconnects and exits
ZCOMM if the phrase CLR is seen immediately following an LF.
v (verbose) The v modifier displays a message when the pattern is
matched. This is often useful when debugging scripts when the
large amount of output generated by large v numeric parameter
values is not desired.
EXAMPLE: pat 5v "Finished Already."
$ Sometimes the only way to recognize a prompt (as distinct from
the same string embedded in other data) is to require the
prompt to be the last thing sent by the remote, before a
pause. The $ modifier allows string to be matched only if the
remote pauses for 1 to 2 seconds after transmitting the last
character in string.
The optional action is a string to be sent to the remote, or
executed as a command if it begins with "@". Action is executed the
instant the last character of the pattern is matched. Action must
not use the goto, f, t, or wait commands.
The pattern command without any arguments clears the patterns that
don't have the p modifier, and terminates pattern searching. The
other events that terminate pattern search are a match to a pattern
that does not have the c modifier, a pattern search timeout, the
call, abort, or quit commands, a major error, or the NUKE key.
EXAMPLE: pat 0c$ "" "\21"
sends one XON character every time there is a pause in output from
the remote. This recovers from situations where the remote computer
stops because it receiveed a spurious XOFF character, or lost an XON
character.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 79
port n Change the modem port to COMn. Legal values for n are 1...8.
Selecting a new port disables hardware handshaking. The currently
defined ports are:
COM1 3F8 IRQ4 (Standard IBM)
COM2 2F8 IRQ3 (Standard IBM)
COM3 3E8 IRQ4 (Alternate)
COM4 2E8 IRQ3 (Alternate)
COM5 2B8 IRQ3 (Columbia)
COM6 2B8 IRQ2 (Alternate for IBM)
COM7 2F8 IRQ2 (Alternate for IBM)
COM8 278 IRQ2 (Alternate for IBM)
COM9 Uses parameters set by the portx command.
COM1 and COM2 are the standard serial ports defined by IBM. COM3
and COM4 are supported by certain serial cards and modem boards.
Columbia computers support COM5. COM6 to COM8 are alternate
configurations that may be accessed by cross jumpering between
printer port decoders and serial port enables on some multifunction
boards. Since ZCOMM uses the interrupt line on the selected port,
no other program or device driver may use the same port address
and/or interrupt vector. Certain disk controllers and mice
interfaces use IRQ2 and IRQ5. Do not use IRQ2 on a PC-AT (the extra
8259 is not reset). Do not select COM3 to COM8 unless you are
familiar with the I/O addresses and interrupt vectors used in your
machine. Ports sharing the same IRQ number cannot be used
concurrently.
The port command resets the d mode (which suppress the Carrier Lost
message).
EXAMPLE: port 2
ZCOMM begins with COM1 unless overidden by the DOS DPORT environment
variable.
EXAMPLE: C>set DPORT=2
SEE ALSO: handshake command
private The private command allows a caller to keyboard a message
which will be appended to a file specified by the string parameter
private. The private command allows the caller to type in up to 64
lines of text. A blank line terminates the message. This command
is intended for short messages; long messages should be uploaded
with a file transfer protocol.
put string The put command transmits string to the remote. Use the
put command for transmittting commands to a modem or a remote
computer system. String is processed for character escapes.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 80
Control and other special characters may be entered with character
escapes described in chapter 22. If a carriage return should be
sent, it must be explicitly coded with \r at the end of the string.
EXAMPLE: put "myname\r" sends myname followed by carriage return
to the modem.
A \336 (octal 336) character causes a pause in transmission
(duration controlled by the p numeric parameter). This pause allows
one string to contain multiple commands.
EXAMPLE: put "\336ATZ\r\336\336ATX1 M0 S0=1\r" pauses, sends
ATZ\r, pauses (twice because some modems take longer to reset!), and
then sends ATX1 etc. to the modem.
Transmission with put is controlled by the 7, 8, h, p, w, and t
modes.
SEE ALSO: putw, mput, putv commands
putw string The putw command transmits string to the remote, and
pauses for a period of time (determined by the q numeric parameter)
before returning from the term function to allow characters to echo.
Other than that final pause, putw operates the same as the put
command.
NOTE: Putw should not be used when the next operation will be a
pattern or wait command. If the expected response starts before the
putw command finishes, the following wait command will never get to
"see" what it is waiting for. In general, the putw command should
only be used as a short-cut for sending a command when the response
is known in advance and can be safely ignored.
SEE ALSO: put, mput commands
putv svar The putv command transmits svar to the remote witnout any
translation of character escapes. Putv does not append a carriage
return or line feed to the transmitted string.
EXAMPLE: putv s0; put "\r"
SEE ALSO: put, mput commands
pwd Print Working Directory displays the current directory pathname,
and stores it in the pwd string parameter.
EXAMPLE: pwd
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 81
SEE ALSO: cd command
pxN Set Numeric parameter x to value N. If x and N are blank, display
the numeric parameters which can be set by this command and their
current values. This command is not allowed if Restricted. Numeric
parameters are described in Chapter 22.
EXAMPLE: ps8 sets the status line attribute to 8 (grey), suitable
for composite video displays.
EXAMPLE: pv-1 sets the v numeric parameter ("verbose") to -1,
suppressing some routine messages.
EXAMPLE: pd1 sets the d numeric parameter to 1, causing files
received with ZMODEM or full YMODEM Batch protocol to be stored with
the same modification date as the source file.
EXAMPLE: pk3 sets the k numeric parameter to 3, which kills
pending output stored in the circulat buffer when ETX (Ctrl-C)
(decimal 3) is keyboarded in the term function.
r [oldcmd] Search back through the history of keyboarded lines for the
first line that oldcmd is a prefix of, and execute it. If oldcmd is
absent, execute the last keyboarded line.
r7 [-options] [dir] [file ...] Receives with options 1 or more files
using MODEM7 batch protocol. An optional disk and/or directory dir
may be specified. An optional disk and/or directory dir may be
specified. If pathname(s) have been supplied to the r7 command and
the sending program attempts to send more files than the number of
names supplied to the r7 command, the transfer is aborted. The
command is provided for compatibility with traditional programs that
do not support the superior YMODEM Batch or ZMODEM protocols.
EXAMPLE: r7 -c
SEE ALSO: MODEM7 batch protocol, Chapter 12.
rb [-options] Receives with options 1 or more files using YMODEM batch
protocol. The rb command also receives files sent with
Clink/SEAlink protocol. Chapter 18 describes the available options.
The pathname and length of each file are transmitted in batch mode.
If a file is received in error (retries exhausted, etc.), the batch
transfer will terminate. If privileges are restricted, a file
received in error will be unlinked (erased).
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 82
EXAMPLE: rb -y
Many programs claiming to support YMODEM actually use XMODEM with
1024 byte blocks; use ZCOMM's sx -k and rx XMODEM commands with
these imposters.
SEE ALSO: YMODEM Batch protocol, Chapter 12.
rb [-options] [dir] [file ...] Receives with options 1 or more files
using YMODEM batch protocol. An optional disk and/or directory dir
may be specified. The optional supplied pathnames file ... are
used in place of pathnames normally provided by the sending program.
If the sending program attempts to send more files than the number
of names supplied to the rb command, the transfer is aborted.
rc [-options] file Receives with options a single file using the Ward
Christensen XMODEM protocol, 128 or 1024 byte blocks, and CRC-16
instead of an 8 bit checksum. ZCOMM signals the sending program
that CRC-16 is to be used. After four errors while attempting to
receive the first sector, ZCOMM will cancel the CRC-16 option and
reverts to checksum operation.
The probability of an undetected transmission error is much less if
CRC-16 is used in place of the default 8 bit arithmetic checksum.
Omen Technology Inc Recommends use of the 16 bit CRC to maintain
data integrity at professional levels.
CRC-16 is not the default because most IBM bulletin boards and
commercial modem programs only support the 8 bit checksum. Chapter
18 describes the available options to the rc command. If privileges
are restricted, a file received in error will be deleted.
EXAMPLE: rc foo.com
SEE ALSO: XMODEM/CRC protocol, Chapter 12.
read [file] Read file into the circular buffer. Once in the buffer,
it may be examined with the review command, searched for strings,
and cut and pasted to other files. If file does not fit into the
buffer, the buffer may be cleared with the kill command (or review k
subcommand) and subsequent read commands may be given to read more
of it. Review function commands are described in Chapter 21.
EXAMPLE: read allsig.tmp<ENTER><Home>
SEE ALSO: BROwse, seek commands
CAUTION: Iff a read command has left a transmit file open, entering
the term function will transmit the unread portion of the file. To
prevent this, close the file first with ALT-C or closetx.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 83
receive Receives file(s) filespec from a Kermit program.
remote Enter Host state with unrestricted privileges to allow the
currently connected remote computer/terminal to issue commands.
When activated by the remote command, Host state will reset when the
modem carrier goes away. This command is useful for transferring
files between two machines with directly connected serial ports.
SEE ALSO: host command
remote cwd dirspec [password] Instructs the remote Kermit server to
change to the specified directory. The form of dirspec varies with
the remote system; it must be quoted if it contains special
characters or spaces. A password may be required by the remote
Kermit server.
SEE ALSO: Kermit Protocol, Chapter 12.
remote delete filespec Instructs the remote Kermit server to delete
the specified file(s). The form of filespec varies with the remote
system; it must be quoted if it contains special characters or
spaces.
remote dir dirspec Instructs the remote Kermit server to display the
specified directory on your screen. The form of dirspec varies with
the remote system; it must be quoted if it contains special
characters or spaces. The resulting information may be redirected
to a file with the >outfile command.
remote help Instructs the remote Kermit server to display help
information on your screen. The resulting information may be
redirected to a file with the >outfile command.
remote host host-command-string Instructs the remote Kermit server to
perform the specified command and display its output on your screen.
The form of host-command-string varies with the remote system; it
must be quoted if it contains special characters or spaces. The
resulting information may be redirected to a file with the >outfile
command.
EXAMPLE: remote host "kill -9 0" terminates all your processes on
the remote with extreme prejudice.
SEE ALSO: !!command
remote print filespec Instructs the remote Kermit server to print the
specified file(s) on the remote system. The form of filespec varies
with the remote system; it must be quoted if it contains special
characters or spaces.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 84
remote space [dirspec] Instructs the remote Kermit server to display
the free space in the specified directory on your screen. The form
of dirspec varies with the remote system; it must be quoted if it
contains special characters or spaces. The resulting information
may be redirected to a file with the >outfile command.
remote type filespec Instructs the remote Kermit server to type the
specified file(s) on your screen. The form of filespec varies with
the remote system; it must be quoted if it contains special
characters or spaces. The resulting information may be redirected
to a file with the >outfile command.
remote who Instructs the remote Kermit server to display the logged in
users on your screen. The resulting information may be redirected
to a file with the >outfile command.
reset Write the contents of the circular buffer if a receive file is
open, close all files, and reset the disk system. This allows
swapping diskettes.
reskeys Resets the Soft Keys to empty.
SEE ALSO: set command
RETurn Returns from a script subroutine accessed by a call, source, or
gosub command.
SEE ALSO: fail command
rewind Reset the buffer pointers for display, printer, and file output
used by the term function to the beginning of the circular buffer.
This will cause the term function to redisplay the data in the
circular buffer. Patterns will be rescanned. A typical use of the
rewind function is to allow replay of an editing session on a remote
machine, or to redisplay the material received if the initial
settings of the i, c, n or v modes were incorrect for the material
received from the remote.
NOTE: The rewind command does not reset the buffer free character
count. To write the data to disk, a write command (or ALT-W) must
be given before accepting new data from the remote.
SEE ALSO: t, b, w review subcommands
REView Review the data received from the host or read by the read
command. A screenfull is displayed at a time. Review function
commands are listed in Chapter 21.
ro [-options] file Receives with options a single file using non-
standard XMODEM-CRC protocol logic. OverThruster(TM) speeds file
downloads at the expense of error recovery. OverThruster operation
is controlled by the O numeric parameter (q.v.). As fans of
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 85
Buckaroo Bonzai know, the OverThruster is not universally
applicable. A transmission error will almost always terminate an
OverThruster file download.
If Restricted, a file received in error will be unlinked (erased).
EXAMPLE: ro foo.com
SEE ALSO: O numeric parameter
rt [-options] [dir] [file ...] Receives with options 1 or more files
using Telink (FIDO) batch protocol. An optional disk and/or
directory dir may be specified. The optional supplied pathnames
file ... are used in place of pathnames normally provided by the
sending program. If pathname(s) have been supplied to the rt
command and the sending program attempts to send more files than the
number of names supplied to the rt command, the transfer is aborted.
The rt command is provided for compatibility with traditional
programs that do not support the superior YMODEM Batch or ZMODEM
protocols.
EXAMPLE: rt -c
SEE ALSO: Telink protocol, Chapter 12.
rw [-options] file Receives with options a single file using the
experimental People-Link WXMODEM protocol. Chapter 18 describes the
available options. If restricted, a file received in error will be
unlinked (erased).
EXAMPLE: rw foo.com
rx [-options] file Receives with options a single file using the Ward
Christensen XMODEM protocol. Chapter 18 describes the available
options. If restricted, a file received in error will be unlinked
(erased).
EXAMPLE: rx foo.com
NOTE: The rc command should be used whenever possible instead of rx.
SEE ALSO: XMODEM protocol, Chapter 12.
rz [-options] Receives with options 1 or more files using ZMODEM batch
protocol. Chapter 18 describes the available options. Each file's
pathname is obtained from the sending program. The +, a, b, n, N,
r, and y options are accepted from the sending program, subject to
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 86
restriced privileges. If the +, b, n, N, r, or y option is
specified to the receiver, it overrides any contrary options
specified to the sender. Only one of the a, b, or r options may be
specified. Only one of the +, n, N, or y options may be specified.
If a file is received in error (retries exhausted, etc.), the batch
transfer will terminate. If privileges are restricted, a file
received in error will be unlinked (erased).
EXAMPLE: rz -y
SEE ALSO: Z mode
SEE ALSO: ZMODEM protocol, Chapter 12.
rz [-options] [dir] [file ...] Receives with options 1 or more files
using YMODEM batch protocol. An optional disk and/or directory dir
may be specified. The optional supplied pathnames file ... are
used in place of pathnames normally provided by the sending program.
If the sending program attempts to send more files than the number
of names supplied to the rz command, the transfer is aborted. To
allow use of the rz command, Z mode (ZMODEM autodownload) should be
turned off with a dis -Z command.
s Displays status information. LSR and MSR refer to the Line Status
Register and Modem Status Register of the selected port 8250 UART
device. If one or more scripts are active, the current line number
(counting from the first line in the script file) for each script
level is displayed.
s7 [-options] pathspec Send the files specified in pathspec using the
MODEM7 batch Protocol. Files which cannot be opened are skipped.
An empty pathspec sends all files in the current directory. A
directory name expands to all regular files in that directory.
If an error aborts a file transmission (retries exhausted, etc.),
batch transfers terminate.
EXAMPLE: s7 *.com sends *.com
NOTE The receiver must be commanded to receive the files. This
command is provided for compatibility with traditional programs that
do not support the superior YMODEM Batch and ZMODEM protocols.
SEE ALSO: MODEM7 batch protocol, Chapter 12.
sb [-options] pathspec Send the files specified in pathspec using the
YMODEM Batch Protocol.[9] The pathname, length, and modification
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 87
time of each file are transmitted. Files which cannot be opened are
skipped. An empty pathspec sends all files in the current
directory. A directory name expands to all regular files in that
directory.
If an error aborts a file transmission (retries exhausted, etc.),
batch transfers terminate. The sb command will send files with
Clink/SEAlink protocol if the receiving program requests Clink.
EXAMPLE: sb -k *.com sends *.com using 1024 byte packets.
NOTE The receiver must be commanded to receive the files with an rb
or rz command.
SEE ALSO: YMODEM Batch protocol, Chapter 12, Clink protocol, Chapter
12.
seek offset Iff a transmit file is open as a result of a f, open, or
read command, position the file read pointer to offset bytes from
the beginning of the file if offset is positive (or 0), or from the
end of the file if offest is negative. "Seek 0" rewinds the file to
its beginning.
EXAMPLE: open baz; seek -20000; read<ENTER>Home reviews the last
20000 bytes of baz.
SEE ALSO: open, read, close
send pathspec Send the specified files with the Kermit protocol. The
send command sends files to either a Kermit server or a regular
Kermit program.
set[s|c|n|?] [[_]sparam string] Set String parameter sparam to string.
As with all ZCOMM strings, the string must be enclosed by double
quote characters if it contains spaces, tabs, or semicolons.
Character escapes must be used to represent special characters,
including return and linefeed if needed.
An optional leading underscore (_) prepended to sparam causes the
string to be cleared by the next call command.
EXAMPLE: set _f1 "logout\r" assigns the string "logout<ENTER>" to
F1 until the next call command.
______________________________________________________________________
9. The receiver may trigger transmssion with the ZMODEM protocol
zcommand command.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 88
The parameters that may be set with this command are described in
Chapter 23.
Set without any arguments will display all non empty string
parameters and their values. If the v (verbose) numeric parameter
is non zero, all string parameters are displayed. The echo and lput
commands may be used to display string parameters ("echo %svar").
The setc command performs string substitutions and character escape
expansions on string before storing. The sets command performs
string substitutions on string before storing.
N.B.: Chapter 24 discusses string concatenation.
EXAMPLE: sets s2 "%z1" assigns the second token (%z1) generated by
the split command to string parameter s2.
If other commands are to follow on the same line, a semicolon must
be used to separate the commands.
EXAMPLE: set s1 "su"; goto sendit would be illegal if the ";" were
left out.
A string parameter may be set to empty with
set sparam ""
(empty string enclosed by double quote characters).
EXAMPLE: pv1; set displays all string parameters, including all
Soft Keys.
EXAMPLE: sets s8 "S9 EQUALS %s9" substitutes the value of string
parameter s9 in the argument before assigning it to s8.
SEE ALSO: echo, if, keys, ALT-K, commands
NOTE: When defining function keys to be called from within the term
function, do not use the t or f commands. Instead use the create or
open commands to prevent excessive term function recursion.
Assigning a string to a function key with the set command causes
that string to be sent to the remote when the key is used within the
term function. If the string begins with @, the remainder of the
string is executed as a ZCOMM command.
EXAMPLE: set f3 "@rb" assigns the rb command to F3.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 89
The setn command stores a decimal number of an arithmetic expression
consisting of decimal numbers, string variables, the length of
atring variables denoted with %, and the oprators +, -, *, and /.
The expression is exaluated strictly left to right.
EXAMPLE: setn vv 1+vv
The set? command stores a decimal number representing the result of
a test condition.
EXAMPLE: set? speed S stores the value of the S test
condition (transmission speed) in string variable speed.
set[s|c] [_]sparam Given with string parameter sparam, but no string,
set reads string from the next line verbatim, with only the trailing
CR/LF removed. The line should not begin with a space or tab unless
one is required for string. This form is handy for entering strings
containing double quotes. If a script is active, the next line is
read from the current script file, otherwise the user is prompted
for it.
NOTE: This form of the set command cannot be used as the predicate
of an if command. The argument should not appear as a label or
telephone directory entry.
EXAMPLE: set outahost
@o; pk3; sp 2400; set disks "abcd"; putw "\336ATM0H1\r" programs
outahost to drop DTR ("o"), set 2400 baud, allow disks a,b,c, and d,
and send an ATM0H1 (go off hook) command to the modem to busy out
the telephone line.
sleep deci-seconds Sleep causes ZCOMM to pause for the specified
tenths of seconds. This command may be used in a script with one or
more put commands to login to a timesharing service. The presence
of a character in the keyboard buffer will cause the sleep to
command to finish at once.
The maximum sleep time is 32000 tenths of seconds. Applications
involving long sleep times may be better handled with the Host
Operation callout queue.
__________
9. Because a failed if command would skip to the next line, the
argument of the set command, and attempt to execute it as a script
line.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands
Revised 09-05-87 Universal Line Printer Edition
ZCOMM User Manual 90
EXAMPLE: sleep 30 pauses for 3 seconds.
SEE ALSO: b numeric parameter
Soft Keys The Soft Keys F5-F40, Ins, Del, Home, End, Up, Down, Left,
Right, PgUp, and PgDn may be programmed with commands by set
commands given in script files, including the "setup" entry in the
distribution PHODIR.T file. The commands assigned to these keys may
be displayed with the keys or ALT-K command.
source sourcefile Accept script commands from sourcefile. The source
and call commands may be nested with up to six[10] scripts open at
once.
Command lines in files accessed by the source command must begin
with a tab, space, or label. Goto commands within sourcefile search
for labels in the same sourcefile. Gosub commands within sourcefile
access subroutines in the telephone directory accessed by the phones
string parameter.
EXAMPLE: bud source /usr/bin/caf/bin/callbud
This telephone directory entry pat calls a separate script file
containing commands to call a secret system. Placing this
information in a separate file keeps it out of the main telephone
directory file, which might be used on a number of computers.
SEE ALSO: gosub command
SPeed m Set the transmission speed ("baud rate") to m. If the speed
specified is odd, or equal to 110, two stop bits are transmitted;
otherwise one stop bit is transmitted.
EXAMPLE: speed 1200
NOTE: Some U.S. Robotics modems cannot accept the sustained full
speed output ZCOMM is capable of. Using speed 2350 corrects such a
problem with the U.S. Robotics Courier 2400.
Some 1200 and 2400 bps modems work better (lower error rate) if the
speed is set to slightly less than the nominal 1200 or 2400. This
also applies to communications networks that cannot accept sustained
__________
10. Deep nesting may require a decrease in circular buffer memory
allocation.
(C) 1987 Omen Tech Inc Chapter 17 Main Commands